home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-2.iso / Files II / Prog / T / Tools Plus 2.6 Evaluation.sit / Tools Plus 2.6 Evaluation Kit / Tools Plus 2.6 / User Manual / 00-Contents next >
Encoding:
INI File  |  1995-04-01  |  15.0 KB  |  446 lines  |  [TEXT/ttxt]

  1. [Display using Monaco 9]
  2.  
  3.  
  4. Contents
  5. ````````
  6.  
  7.   1  Introduction to Tools Plus
  8.          What is Tools Plus
  9.          An Overview of Tools Plus
  10.          The Tools Plus Advantage
  11.          Who can benefit from Tools Plus
  12.          What kind of applications can be written with Tools Plus
  13.          What is Tools Plus not suitable for
  14.          System Requirements
  15.          Assumptions made when writing this manual
  16.          Conventions used throughout this manual
  17.          Software Updates
  18.          For your information (recommended reading)
  19.  
  20.   2  Installing Tools Plus
  21.          Tools Plus Segments in Your Application
  22.          Installing Tools Plus in THINK C
  23.              Adding Tools Plus to a THINK C Project
  24.          Installing Tools Plus in THINK Pascal
  25.              Adding Tools Plus to a THINK Pascal Project
  26.              After Compiling
  27.          Installing Tools Plus in CodeWarrior C (68K)
  28.              Adding Tools Plus to a CodeWarrior C (68K) Project
  29.          Installing Tools Plus in CodeWarrior Pascal (68K)
  30.              Adding Tools Plus to a CodeWarrior C (68K) Project
  31.          Installing Tools Plus in CodeWarrior C (PPC)
  32.              Adding Tools Plus to a CodeWarrior C (PPC) Project
  33.          Installing Tools Plus in CodeWarrior Pascal (PPC)
  34.              Adding Tools Plus to a CodeWarrior C (PPC) Project
  35.          Compiling the THINK C Demo Application
  36.          Compiling the THINK Pascal Demo Application
  37.          Compiling the CodeWarrior C (68K) Demo Application
  38.          Compiling the CodeWarrior Pascal (68K) Demo Application
  39.          Compiling the CodeWarrior C (PPC) Demo Application
  40.          Compiling the CodeWarrior Pascal (PPC) Demo Application
  41.  
  42.   3  Designing Your Application
  43.          Overview
  44.          A Macintosh Event, in Brief
  45.          Macintosh Event Queue
  46.          Key Up Events
  47.          Tools Plus Events
  48.          The Main Event Loop
  49.          System 5 and 6’s Finder and MultiFinder, and System 7
  50.              Finder
  51.              MultiFinder
  52.              System 7
  53.          The C Header file (ToolsPlus.h)
  54.          Range Checking
  55.          What to read next
  56.  
  57.   4  Initialization
  58.          Initializing Tools Plus
  59.          Initialization Failure
  60.          Other Initialization
  61.          The Cursor
  62.  
  63.   5  Windows
  64.         Overview
  65.             Window Types
  66.             Title Bar, Close box, and Zoom box
  67.             Size Box
  68.             Maximum Number of Open Windows
  69.             Tool Bar and Floating Palettes
  70.             Standard Windows
  71.             Active Window
  72.             Work Window
  73.             Current Window
  74.             Editing Field Window
  75.             Modal Windows
  76.             Window Layers
  77.             Global and Local Co-ordinates
  78.             Handling Windows
  79.         Opening a window
  80.             Floating Palettes
  81.         Opening a tool bar
  82.         Closing a window, tool bar, or palette
  83.         Changing a window’s size
  84.         Moving a window
  85.         Hiding/showing a window
  86.         Activating a window
  87.         Making a window current without activating it
  88.         Making the active window current
  89.         Changing a window’s title
  90.         Setting a window’s size limits
  91.         Setting the “standard” and “user” co-ordinates for zooming
  92.         Getting the “standard” and “user” co-ordinates for zooming
  93.         Getting a window’s status information
  94.         Getting your app’s active window number
  95.         Getting your app’s current window number
  96.         Getting your app’s front most window number
  97.         Getting your app’s tool bar number
  98.         Getting your app’s front most floating palette’s number
  99.         Getting your app’s front most standard window number
  100.         Getting your app’s work window number
  101.         Getting the window number of your app’s active edit field
  102.         Determining if a window is open
  103.         Determining if a window is visible
  104.         Determining a window’s type
  105.         Getting a window’s pointer
  106.  
  107.   6  Buttons
  108.         Overview
  109.             Button Types
  110.             Button States
  111.             Button Titles
  112.             Fonts
  113.             Default Button
  114.             Handling Buttons
  115.         Creating a new button
  116.             Fonts
  117.             Default Button
  118.         Deleting a button
  119.         Enabling/Disabling a button
  120.         Selecting/Deselecting a button
  121.         Determining if a button is enabled
  122.         Determining if a button is selected
  123.         Changing a button’s title
  124.         Flashing a button (simulating selection)
  125.         Setting a default button
  126.         Removing the “default button” status from a window
  127.  
  128.   7  Picture Buttons
  129.         Overview
  130.             Button Types
  131.             Button Behavior
  132.             Selection Effects
  133.             Disabling Effects
  134.             Button’s Value and Stages
  135.             Handling Picture Buttons
  136.         Creating a new picture button
  137.             Resource IDs
  138.                 Icon Resource IDs
  139.                 3D SICN Buttons
  140.                 PICT Resource IDs
  141.             Behavior and Appearance Specification
  142.             Rate of Repeating Events
  143.         Deleting a picture button
  144.         Enabling/Disabling a picture button
  145.         Selecting/Deselecting a picture button
  146.         Getting a picture button’s minimum value limit
  147.         Setting a picture button’s minimum value limit
  148.         Getting a picture button’s maximum value limit
  149.         Setting a picture button’s maximum value limit
  150.         Getting a picture button’s current value
  151.         Setting a picture button’s current value
  152.         Setting a picture button’s value and selection state
  153.         Setting a picture button’s value change rate
  154.         Setting a picture button’s value change speed
  155.         Determining if a picture button is enabled
  156.         Determining if a picture button is selected
  157.         Flashing a picture button (simulating selection)
  158.  
  159.   8  Scroll Bars
  160.         Overview
  161.             Scroll Bar States
  162.             Handling Scroll Bars
  163.         Creating a new scroll bar
  164.         Deleting a scroll bar
  165.         Enabling/disabling a scroll bar
  166.         Getting a scroll bar’s minimum value limit
  167.         Setting a scroll bar’s minimum value limit
  168.         Getting a scroll bar’s maximum value limit
  169.         Setting a scroll bar’s maximum value limit
  170.         Getting a scroll bar’s current value
  171.         Setting a scroll bar’s current value
  172.  
  173.   9  Editing Fields
  174.         Overview
  175.             Field Capacity
  176.             Alignment of text in a field
  177.             The Window’s Active Field
  178.             Activating a Field
  179.             Editing Field Window
  180.             The Field’s String & Edited Text
  181.             Fonts
  182.             Length Limited Fields
  183.             Word Wrap
  184.             Clicking and Tabbing in fields
  185.             Using Fields
  186.             Mac 512KE and Mac Plus keyboard with numeric pad
  187.             The Edit Menu
  188.             Handling Fields
  189.             Special Handling of Fields
  190.         Creating a new field
  191.             Fonts
  192.         Deleting a field
  193.         Activating a field
  194.         Deactivating a field
  195.         Clicking in an inactive field
  196.         Getting the active field’s edited text
  197.         Saving the active field’s edited text as the field’s string
  198.         Getting the window number of your app’s active edit field
  199.         Getting the active field’s number
  200.         Turning field length limiting on/off
  201.         Repositioning a field
  202.             Scrolling fields
  203.         Pasting into a field under your application’s control
  204.  
  205.   10  List Boxes
  206.         Overview
  207.             Fonts
  208.             Handling List Boxes
  209.         Creating a new list box
  210.             Selection Methods
  211.             Fonts
  212.         Deleting a list box
  213.         Adding a new line / replacing an existing line in a list box
  214.         Getting a line’s text
  215.         Searching lines for specific text (alphabetic order)
  216.         Selecting/Deselecting a line
  217.         Determine if a line is selected
  218.         Determine the next selected line number
  219.         Inserting a blank line into a list box
  220.         Deleting a line
  221.         Turning a list box’s drawing on/off
  222.  
  223.   11  Pop-Up Menus
  224.         Overview
  225.             Command Keys & Hierarchical Pop-Up Menus
  226.             Handling Pop-Up Menus
  227.         Creating a new pop-up menu
  228.             Appearance and Behavior
  229.             Pop-Up Menus on Color Backgrounds
  230.         Adding, changing or renaming a pop-up menu item
  231.             Metacharacters
  232.         Inserting a pop-up menu item
  233.         Deleting a pop-up menu or pop-up menu item
  234.         Getting a pop-up menu item’s text
  235.         Renaming a pop-up menu item
  236.         Enabling or disabling a pop-up menu or pop-up menu item
  237.         Determine if a pop-up menu is enabled
  238.         Displaying or hiding the Check mark
  239.         Displaying or hiding special marks
  240.         Getting a pop-up menu item’s special mark
  241.         Setting a pop-up menu item’s icon
  242.         Getting a pop-up menu item’s icon
  243.         Changing a pop-up menu item’s style
  244.         Determining the number of items in a pop-up menu
  245.         Determining the selected item in a pop-up menu
  246.  
  247.   12  Menus
  248.         Overview
  249.             Menus Accessed by MultiFinder and System 7
  250.             Edit Menu
  251.             Desk Accessories
  252.             Menus and Editing Fields
  253.             Menus and Desk Accessories
  254.             Command Key Equivalents
  255.             Handling Menus
  256.         Creating the Apple menu
  257.         Creating and renaming a menu or menu item
  258.             Metacharacters
  259.         Attaching or detaching a hierarchical menu
  260.         Inserting a menu item
  261.         Deleting a menu or menu item
  262.         Updating the menu bar (redrawing it)
  263.         Getting a menu item’s text
  264.         Renaming a menu item
  265.         Enabling or disabling a menu or menu item
  266.         Displaying or hiding the Check mark
  267.         Displaying or hiding special marks
  268.         Getting a menu item’s special mark
  269.         Setting a menu item’s Command-key equivalent
  270.         Getting a menu item’s Command-key equivalent
  271.         Setting a menu item’s icon
  272.         Getting a menu item’s icon
  273.         Changing a menu item’s style
  274.         Determining the number of items in a menu
  275.         Determining a menu’s parent menu
  276.         Determining a menu item’s submenu
  277.         Highlight or unhighlight a menu
  278.  
  279.   13  Cursors
  280.         Overview
  281.             Automatic Cursor Changes
  282.             The Watch Cursor
  283.             Starting your application
  284.             The Cursor Table
  285.             Advanced Features
  286.             Cursor Animation
  287.             Handling Cursors
  288.         Changing the cursor’s shape
  289.         Resetting cursor shape according to window orientation
  290.         Creating a new cursor table
  291.         Deleting a cursor table
  292.         Creating/replacing a cursor zone (using a rectangle)
  293.         Creating/replacing a cursor zone (using a region)
  294.         Deleting a cursor zone
  295.         Getting a cursor zone’s bounding rectangle
  296.         Getting a cursor zone’s region
  297.         Indicate that cursor zone regions have been altered
  298.         Making a window use a cursor table (or stop using one)
  299.         Determining which cursor zone contains a specified point
  300.         Enabling/disabling button clicks during a watch cursor
  301.  
  302.   14  System Polling
  303.         Overview
  304.         What Is Polling?
  305.         Task Switching
  306.         Background Processing
  307.         Macintosh Events
  308.         Watch Cursor -- a busy system
  309.         The Event Queue
  310.         Tools Plus Event Record
  311.         Event Record Fields
  312.         Event Modifiers
  313.             Event Modifiers Using C
  314.             Event Modifiers Using Pascal
  315.         PollSystem (System polling)
  316.             Tools Plus Event Codes
  317.             What Does PollSystem Do?
  318.                 Internally Processed Events
  319.                 Externally Processed Events
  320.             Inside PollSystem
  321.             Translating Toolbox events to Tools Plus events
  322.         Responding to Events
  323.             doNothing
  324.             doChgWindow
  325.             doRefresh
  326.             doPreRefresh
  327.             doGoAway
  328.             doButton
  329.             doMenu
  330.             doKeyDown
  331.             doAutoKey
  332.             doKeyUp
  333.             doClickField
  334.             doScrollBar
  335.             doListBox
  336.             doClick
  337.             doPopUpMenu
  338.             doPictButton
  339.             doClickControl
  340.             doManual
  341.             doMoveWindow
  342.             doGrowWindow
  343.             doClickDesk
  344.             doZoomWindow
  345.             doSuspend
  346.             doResume
  347.             doChgInField
  348.         Scheduling background processing
  349.         Determining if "scheduling processing" is supported
  350.         Discontinuing multiple clicks or drags
  351.         Determining if your application is suspended
  352.         “Field to Event” Cross reference
  353.  
  354.   15  Color Drawing & Multiple Monitors
  355.         Overview
  356.             Using One Monitor
  357.             Using Multiple Monitors
  358.             Changing Screen Settings
  359.         Determining if Color QuickDraw is used
  360.         Determining the number of logical screens
  361.         Beginning color-dependent drawing on a window
  362.         Ending color-dependent drawing on a window
  363.         Determining the number of colors on a screen
  364.         Determining if the screen is set to draw in color
  365.         Resetting the current window’s pen to default values
  366.         Getting the current window’s pen settings
  367.         Setting the current window’s pen settings
  368.  
  369.   16  User Notification
  370.         Overview
  371.             Notifying the User
  372.         Define settings for notifying the user
  373.         Notifying the user that your application needs attention
  374.  
  375.   17  Dynamic Alerts
  376.         Overview
  377.             Icons
  378.             Text
  379.             Buttons
  380.             Function’s Value
  381.             Automatic User Notification
  382.             Alerts Samples
  383.         Displaying a Dynamic Alert
  384.             Custom Button Combinations
  385.         Changing button titles on Dynamic Alerts
  386.  
  387.   18  Miscellaneous Routines
  388.         Overview
  389.         Drawing an icon
  390.             Intelligent Icon Drawing
  391.             Icon Family
  392.             Icon Selection
  393.             Drawing the Icon, Selecting, Disabling, and Masking
  394.             Creating Your Own Icons
  395.         Set the default appearance for disabled icons
  396.             Default Appearance for Disabled Icons
  397.         Determining the System version
  398.         Play the System Error sound
  399.         Wait for a specified time
  400.         Drawing “Zoom Lines”
  401.         Drawing a standard Macintosh progress thermometer
  402.         Determining the minimum value of two numbers
  403.         Determining the maximum value of two numbers
  404.  
  405.   19  Other Macintosh Features
  406.         Overview
  407.             Alerts
  408.             Dialogs
  409.             Custom Controls
  410.             Lists
  411.  
  412.   20  Memory
  413.         Overview
  414.             Editing Fields
  415.             Measurements
  416.             Routines that consume heap space (by category)
  417.             Routines that consume heap space (alphabetic)
  418.             The Style Table
  419.             Good memory habits
  420.  
  421.   21  Font Heights
  422.         Font heights table
  423.  
  424.   22  Special Routines
  425.         Use these routines with caution, or don’t use them!
  426.  
  427.   23  Completing Your Application
  428.         Overview
  429.         Application’s Icons
  430.         Icon Family
  431.         File Types, Creators, and the Application Signature
  432.         Signature (the Creator code)
  433.         Bundle
  434.         Version
  435.         mstr Resources
  436.         SIZE Resource
  437.         Cloned SIZE resources
  438.  
  439.   24  Technical Support
  440.         What does Technical Support do?
  441.         What doesn’t Technical Support do?
  442.         Electronic Mail (E-mail) Support
  443.         Mail Support
  444.         Software Updates
  445.         Software Upgrades
  446.